Contexto global.LockDataForEdit

Contexto global

LockDataForEdit

Disponible desde la versión 8.2.

Sintaxis:

LockDataForEdit(<Clave>, <VersiónDatos>, <IdentificadorFormulario>)

Parámetros:

<Clave> (obligatorio)

Tipo: Cualquier referencia a un objeto de la base de información, ClaveRegistroInformación., RefTablaFuenteExterna.., ClaveRegistroTablaFuenteExterna...
Referencia al objeto que se debe bloquear o clave de registro del registro independiente del registro de información que se debe bloquear.

<VersiónDatos> (opcional)

Tipo: Cadena.
Versión del objeto que se está bloqueando en formato Base64. Se utiliza si el parámetro <Clave> tiene el tipo Cualquier referencia a objeto de la base de información.
Si se especifica, se verifica la versión del objeto en la base de datos al bloquear el objeto. Si la versión no coincide o el objeto no está presente en la base de datos, se genera una excepción.

<IdentificadorFormulario> (opcional)

Tipo: UUID.
Identificador único del formulario. Si se especifica el parámetro, se establece un bloqueo durante toda la vida útil del formulario en el que se ha establecido. Tenga en cuenta que si no se han establecido otros bloqueos en nombre de este formulario durante el tiempo de visualización del formulario (a través de la edición interactiva o el método LockFormDataForEdit), al cerrar el formulario, el bloqueo puede cancelarse no inmediatamente, sino después de un tiempo. El bloqueo se puede liberar:

  • automáticamente al cerrar el formulario o completar la sesión;
  • con la ayuda del método del contexto global UnlockDataForEdit con indicación del mismo identificador de formulario que se especificó para el bloqueo. En este caso, el bloqueo se libera inmediatamente.

Si no se especifica el parámetro, se establece un bloqueo durante un tiempo limitado y se puede cancelar:
{bullet1}utilizando el método UnlockDataForEdit sin identificador de formulario;
al completar la transacción, si el bloqueo se establece en la transacción;
al finalizar el trabajo con el script de 1C:Enterprise (para el cliente ligero y el cliente web cuando el control vuelve del servidor);
al salir de la sesión.{/bullet1}

Descripción:

Bloquea los datos en un formulario de aplicación cliente (los hace de solo lectura).
Si el objeto ya ha sido bloqueado (con el método Lock o por cualquier otro medio), el método genera una excepción.

Disponibilidad:

Servidor, cliente grueso, conexión externa, aplicación móvil (servidor), servidor independiente móvil.

Véase también:

Contexto global, método UnlockDataForEdit

Disponible desde:

Disponible desde la versión 8.2.